home *** CD-ROM | disk | FTP | other *** search
/ Multimedia Jumpstart / Multimedia Microsoft Jumpstart Version 1.1a (Microsoft).BIN / develpmt / source / rleapp / readme.txt < prev    next >
Encoding:
Text File  |  1992-09-12  |  3.8 KB  |  100 lines
  1. rleapp - RLE Sample Application. Multimedia Systems Group
  2.  
  3.      (C) Copyright Microsoft Corp. 1991, 1992.  All rights reserved.
  4.  
  5.      You have a royalty-free right to use, modify, reproduce and 
  6.      distribute the Sample Files (and/or any modified version) in 
  7.      any way you find useful, provided that you agree that 
  8.      Microsoft has no warranty obligations or liability for any 
  9.      Sample Application Files which are modified. 
  10.      
  11.      If you did not get this from Microsoft Sources, then it may not be the
  12.      most current version.  This sample code in particular will be updated
  13.      and include more documentation.  
  14.  
  15.      Sources are:
  16.          The MM Sys BBS: The phone number is 206 936-4082.
  17.     CompuServe: WINSDK forum, MDK section.
  18.     Anonymous FTP from: ftp.uu.net vendors\microsoft\multimedia\samples
  19.  
  20. Version 1.2     Released 02/28/92
  21.  
  22. this sample ONLY works on the following:
  23.  
  24.     a 386 or better
  25.     Windows 3.1 (or Windows 3.0 + MME 1.0 + COMMDLG)
  26.  
  27. File           |Description
  28. ---------------|--------------------------------------------------------------
  29. df.asm        RLE routines including delta-frame.  Very usefull.
  30.         This file is the heart of this sample code.
  31. df.h        Include file for df.asm
  32. dib.c        General DIB handling routines.  WARNING: there are
  33.         many different versions of this file contained
  34.         in the sample code.
  35. dib.h        Include file for dib.c
  36. gmem.h        Protect mode global memory optimizations
  37. makefile    The infamous makefile
  38. mem.asm        General memory routines
  39. rle.c        RLE and Delta-frame interfaces and general routines
  40. rle.h        Include file for rle.c
  41. rlea.asm    386 version of some routines in rle.c
  42. rleapp.c    The main functions/ where the app lives
  43. rleapp.def    Our app's DEF
  44. rleapp.dlg    Our app's dialogs
  45. rleapp.h    Our app's main include file
  46. rleapp.ico    Our app's icon
  47. rleapp.rc    Our app's resource file
  48. rledlg.c    Dialog handling routines
  49. rledlg.h    Include for rledlg.c
  50. rlefile.c    Animation file I/O
  51.  
  52. ---------------------------------------------------------------------------
  53. Notes about this sample
  54.  
  55. This sample app is called rle.exe even though the ZIP file is RLEAPP.ZIP.
  56.  
  57. The application can be used to load, generate, play and save animations
  58. using the DIB RLE format for delta-frames.
  59.  
  60. The RLE format is described in the Windows 3.0 SDK docs in the section
  61. on the BITMAPINFOHEADER structure.  It is described in the Multimedia
  62. SDK (MDK) in the Programmer's Reference in the section entitled 
  63. "Windows 3.0 Bitmap Compression Formats".
  64.  
  65. This app only handles 8bpp DIBS, even though the same technology
  66. applies to 4bpp DIBs (RLE, delta-frame, etc).
  67.  
  68. Sample animations can be obtained from the MM System's BBS at 206 936-4082
  69. in the VIDEOS library, or look where you obtained this sample.
  70.  
  71. This sample code includes many optimizations for 386-specific machines.
  72. This is a very usefull way to increase speed because the MPC spec
  73. calls for a 386 as a minimum, so in most cases, the 286 support
  74. can be left out.
  75.  
  76. This program is very dependant on blit speed of the video card and driver.
  77. In most cases, the video driver is very ssslllooowww doing blits.
  78. Complain to your card manufacturer if you think it should be faster.
  79. You should be able to blit 160x120 256 color frames (with the same
  80. palette) at at least 15 frames/second.  Bad drivers/card will be
  81. able to do about 1 frame/second.
  82.  
  83.  
  84.  
  85. ---------------------------------------------------------------------------
  86.  
  87. I am planning on releasing an AutodeskR file converter to RLE and RL0
  88. format converter soon.  The capability to read these files will
  89. be built in to future versions of this sample code.
  90.  
  91. If you have any comments/questions/requests about this sample, you
  92. can reach me at the BBS, or by FAX at 206 93MSFAX.
  93.  
  94.  
  95. Please let me know if this sample code is usefull to you.
  96.  
  97. Matt Saettler
  98. 76150,2523
  99.  
  100.